home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / EXP_3DS.1 next >
Encoding:
Text File  |  1996-06-13  |  3.4 KB  |  72 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Export-3D-Studio 
  3. .SH NAME
  4. exp_3ds \- 3D Studio geometry export filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the 3D Studio 
  8. geometry export converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a Wavefront file to 3D Studio using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i wave -o 3ds filename.obj
  16. .PP
  17. .SH OVERVIEW
  18. .PP
  19. The 3D Studio geometry export converter writes out the entire scene database
  20. as smoothed triangle meshes along with their associated material definitions
  21. as well as all lights and cameras that are defined in the converter's
  22. database.
  23. .PP
  24. This converter outputs almost every possible 3D Studio file attribute.
  25. For materials, a partial list includes all texture maps (texture # 1, texture # 2,
  26. reflect map, bump map, shininess map and opacity map), automatic planar & cubical
  27. environment maps, transparency values, phong values and shading modes (flat
  28. to metal). Note: the converter also does shading parameter matching so that, for
  29. example, colors and textures read in from Lightwave will be rendered fairly
  30. closely when exported to 3D Studio. Other exported attributes include view
  31. port settings, atmospheric effects and background color schemes.
  32. .PP
  33. All polygons will be converted into triangles, including concave polygons and
  34. polygons with holes. Once converted, an algorithm will be invoked which
  35. assigns unique smoothing group numbers to the triangle meshes so that 
  36. the destination program can reconstruct the vertex normals (.3ds files
  37. have no vertex normal information in them).
  38. .PP
  39. Texture coordinates will also be output along with the triangular meshes if
  40. texture data exists.
  41. .PP
  42. If an object has more than 65535 polygons, vertices or texture coordinates
  43. then a complex algorithm will be invoked to split the object apart into
  44. multiple pieces, each with less than 65535 polygons, vertices and texture 
  45. coordinates. Each object will share the same name but have a different
  46. number appended to the end of the name. Please take note that the new sub-objects
  47. created will not share the same smoothing group (due to a 3D Studio limitation),
  48. and thus smoothing will not occur between the new sub-objects within 3D
  49. Studio. For example, if a sphere which consists of 120000 polygons is exported
  50. to a 3D Studio file then the sphere will be broken up into 2 sub-objects;
  51. the seam between the two sub-objects will not appear to be smooth when 
  52. rendered within 3D Studio because of this smoothing limitation.
  53. .PP
  54. .SH LIMITATIONS
  55. .PP
  56. Object names in a 3D Studio file are limited to 10 characters and material
  57. names are limited to 16 characters. If any exported name is found to be
  58. longer than these limits then the converter will truncate the name and
  59. make it unique by appending a number to last character in the name.
  60. .PP
  61. 3D Studio has a limit of 65535 polygons, vertices or texture coordinates
  62. per object. Objects broken up into multiple sub-objects may have not
  63. appear to be smooth where the sub-objects intersect.
  64. .PP
  65. .SH COMMAND LINE OPTIONS
  66. .PP
  67. The following options are specific to this export converter:
  68. .TP
  69. -o 3ds
  70. This is the mandatory command line option which specifies that the data
  71. is to be exported using the 3D Studio format converter.
  72.